home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 43 / Amiga Format CD43 (1999)(Future Publishing)(GB)(Track 1 of 2)[!][issue 1999-09].iso / -serious- / programming / other / hunk / hunk.readme < prev    next >
Text File  |  1999-06-14  |  6KB  |  153 lines
  1. Short:    Editor for hunk structure of binary files with GUI
  2. Uploader: thor@einstein.math.tu-berlin.de (Thomas Richter)
  3. Author:   thor@einstein.math.tu-berlin.de (Thomas Richter)
  4. Type:     dev/misc
  5. Version:  2.15
  6. _____________________________________________________________________________
  7.  
  8.                          The THOR-Software Licence (v2, 24th June 1998)
  9.  
  10.  
  11. This License applies to the computer programs known as "The Hunk Processor",
  12. or short "Hunk". The "Program", below, refers to such program. The
  13. "Archive" refers to the package of distribution, as prepared by the author
  14. of the Program, Thomas Richter. Each licensee is addressed as "you".
  15.  
  16.  
  17.  
  18. The Program and the data in the archive are freely distributable
  19. under the restrictions stated below, but are also Copyright (c)
  20. Thomas Richter.
  21.  
  22. Distribution of the Program, the Archive and the data in the Archive by a
  23. commercial organization without written permission from the author to any
  24. third party is prohibited if any payment is made in connection with such
  25. distribution, whether directly (as in payment for a copy of the Program) or
  26. indirectly (as in payment for some service related to the Program, or
  27. payment for some product or service that includes a copy of the Program
  28. "without charge"; these are only examples, and not an exhaustive enumeration
  29. of prohibited activities).
  30.  
  31.  
  32. However, the following methods of distribution
  33. involving payment shall not in and of themselves be a violation of this
  34. restriction:
  35.  
  36.  
  37. (i) Posting the Program on a public access information storage and
  38. retrieval service for which a fee is received for retrieving information
  39. (such as an on-line service), provided that the fee is not
  40. content-dependent (i.e., the fee would be the same for retrieving the same
  41. volume of information consisting of random data).
  42.  
  43.  
  44. (ii) Distributing the Program on a CD-ROM, provided that
  45.  
  46. a) the Archive is reproduced entirely and verbatim on such CD-ROM, including
  47. especially this licence agreement;
  48.  
  49. b) the CD-ROM is made available to the public for a nominal fee only,
  50.  
  51. c) a copy of the CD is made available to the author for free except for
  52. shipment costs, and
  53.  
  54. d) provided further that all information on such CD-ROM is redistributable
  55. for non-commercial purposes without charge.
  56.  
  57.  
  58. Redistribution of a modified version of the Archive, the Program or the
  59. contents of the Archive is prohibited in any way, by any organization,
  60. regardless whether commercial or non-commercial. Everything must be kept
  61. together, in original and unmodified form.
  62.  
  63.  
  64.  
  65.  
  66. Limitations.
  67.  
  68.  
  69. THE PROGRAM IS PROVIDED TO YOU "AS IS", WITHOUT WARRANTY. THERE IS NO
  70. WARRANTY FOR THE PROGRAM, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT
  71. LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
  72. PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS. THE ENTIRE
  73. RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD
  74. THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY
  75. SERVICING, REPAIR OR CORRECTION.
  76.  
  77.  
  78. IF YOU DO NOT ACCEPT THIS LICENCE, YOU MUST DELETE THE PROGRAM, THE ARCHIVE
  79. AND ALL DATA OF THIS ARCHIVE FROM YOUR STORAGE SYSTEM. YOU ACCEPT THIS
  80. LICENCE BY USING OR REDISTRIBUTING THE PROGRAM.
  81.  
  82.  
  83.                                                         Thomas Richter
  84.  
  85. _____________________________________________________________________________
  86.  
  87. The "Hunk Processor" is a tool for editing the hunk structure of binary
  88. AmigaDOS load files (not object codes that must be linked afterwards, but
  89. complete executable binaries). 
  90.  
  91. Functions:
  92.  
  93.     Add and remove hunks, as well as relocation entries.
  94.     Merge hunks to shorten programs without "crunching".
  95.     Code optimizer to remove unnecessary jumps.
  96.     Rexx interface for automatic operation.
  97.  
  98.  
  99. The "Hunk Processor" is a quiet old program I wrote years ago, so the GUI 
  100. looks probably a bit "outdated" - but this is a tool, not a piece 
  101. of artwork. I mostly use it to patch bugs in existing programs, together 
  102. with a standard debugging tool.
  103. The plus of the "Hunk Processor" is that it keeps the relocation data after
  104. loading an executable, so after patching it the "Hunk Processor" can re-
  105. create a loadable program; the ARexx interface can be used to automatize
  106. this procedure or to simplify parts of it.
  107. "Hunk" comes with a - very simple though - build-in language for automatized
  108. optimization of executables, and some examples of these "external Hunk 
  109. OPtimizers", or "hoppers" for short.
  110.  
  111.  
  112. Extras:
  113.     -    A Rexx program that prints out all relocation data.
  114.     -    A Rexx program for automatic replacement of the
  115.         relocation hunks with the more efficient Reloc32Short 
  116.         hunks.
  117.     -    A lot of external "Hunk Optimizers", i.e. "hop" files.
  118.  
  119. _____________________________________________________________________________
  120.  
  121. The program is freeware, but the guide is not! It's priced $10, to be sent to
  122. my address:
  123.  
  124.  
  125. Thomas Richter
  126. Rühmkorffstraße 10 A
  127.  
  128. 12209 Berlin
  129.  
  130.  
  131. The guide contains the complete syntax of the .hop files, the available
  132. ARexx commands, a tutorial how to use this hunk and the complete description
  133. of all functions. I guess $10 is really not overpriced for the amount of
  134. work I invested in this program and the guide.
  135.  
  136. _____________________________________________________________________________
  137.  
  138. Changes made in 2.15:
  139.  
  140.     Fixed a problem with one of the memory copy operations. It used
  141.     overlapping domains which are not officially supported by the Os. 
  142.     Fixed.
  143. _____________________________________________________________________________
  144.  
  145. Changes made in 2.14:
  146.  
  147.     Added more ARexx commands. More in the guide.
  148. _____________________________________________________________________________
  149.  
  150. Thomas,
  151.     June 1999
  152.  
  153.